home *** CD-ROM | disk | FTP | other *** search
/ Network Supervisor's Toolkit / Network Supervisor's Toolkit.iso / e-mail / net-send / nsend.doc < prev    next >
Text File  |  1996-07-10  |  12KB  |  289 lines
  1.  
  2.                              NSend/NGet Version 1.1
  3.  
  4.                         Copyright 1994 by Matt E. Hart
  5.  
  6.  
  7.     NSEND11.ZIP
  8.  
  9.     Packing List:
  10.  
  11.         NSEND.EXE
  12.         NGET.EXE
  13.         NSEND.DOC
  14.  
  15. This program is Shareware.  You are free to distribute it as long as all three
  16. files in the above list are included and unmodified.  If you like and use the
  17. program, please register it by sending $25 U.S. to:
  18.  
  19.                             Matt E. Hart
  20.                             2516 W. Kingsport
  21.                             Broken Arrow, OK  74011
  22.  
  23. I will be updating the program periodically.  A number of enhancements are
  24. planned for the future, but will only be included in the registered version.
  25. The "t" option - send a text file - will be ready for release in the first
  26. registered version.
  27.  
  28.    Support is available at the above address, or on CompuServe at 75450,3705
  29.  E-Mail can be sent through the Internet to address 75450.3705@compuserve.com
  30. ------------------------------------------------------------------------------
  31.  
  32.  
  33. NSEND
  34. ------------------------------------------------------------------------------
  35. NSend is a replacement for the SEND command included with NetWare.  NSend is
  36. fully compatible with SEND parameters, except for the station number (which
  37. nobody uses anyway), so you can replace SEND.EXE with NSEND.EXE.  NSend is
  38. intended as a no-brainer e-mail system.  It is fast and easy to use, and
  39. requires no TSR's.  In order for NSend to save messages, all users must have
  40. read/write priviledges to a \PUBLIC\NSEND directory on the server.  Create an
  41. NSEND sub-directory underneath \PUBLIC before using NSend. The NSend
  42. parameters are:
  43.  
  44. NSend {switches} "message text" [TO] [USER|GROUP], [SERVER/USER|GROUP],...
  45. {switches}
  46.     f    Save to file only, don't send
  47.     n    Save to file only if unable to send - default
  48.     s    Send only - don't save
  49.     b    Both save and send
  50.     t    Send text file as message (Included with the registered version!)
  51.         Example: C:\>nsend t "c:\updates\update.txt" to mikebohn
  52.  
  53. The normal SEND command is:
  54.  
  55. SEND "message text" [TO] [USER|GROUP], [SERVER/USER|GROUP],...
  56.  
  57.  
  58. NSend adds these switches:
  59.  
  60.     f - No message is broadcast.  The "message text" is saved to the user's
  61.         message file.
  62.     n - The message is broadcast.  The "message text" is saved to the user's
  63.         message file ONLY if the user did not receive the message.  A message
  64.         won't be received if the user is not logged in or attached to a
  65.         server.  This is the default NSEND mode and is active when no switches
  66.         are used.
  67.     s - The message is broadcast.  The "message text" is NOT saved, regardless
  68.         of whether the user received the message.  This is exactly the same as
  69.         the normal SEND command.
  70.     b - The message is broadcast.  The "message text" is saved to the user's
  71.         message file.
  72.     t - Send a text file as a message.  The "message text" parameter is a path
  73.         and name of a file, rather than a message to be broadcast.  Any size
  74.         text file can be sent.
  75.  
  76. NSend will report the status of sent messages in the same manner as SEND.
  77. Error messages are:
  78.  
  79.     "t" Parameter errors
  80.     --------------------
  81.     NSend error - File not found {textfile.ext}
  82.         [Unable to locate the file entered in the "message text" parameter]
  83.     NSend error - File empty {textfile.ext}
  84.         [The file entered in the "message text" parameter has no lines]
  85.  
  86.     NSend error - Unable to find preferred or primary server connection
  87.         [Sender isn't logged in]
  88.  
  89.     {file server} - {user/group} - Invalid User
  90.         [A [SERVER/USER|GROUP] parameter is invalid.  Sender may not be logged
  91.          in or attached to the server, or the user or group isn't listed on
  92.          that server.]
  93.  
  94.     {file server} - {user} - NOT Sent
  95.         [User isn't logged in or attached]
  96.  
  97.     {file server} - {user} - Sent
  98.         ["message text" was sent to the user]
  99.  
  100.     {file server} - {user} - Unable to save to file {userfile.msg}
  101.         [The "message text" could not be written to a user's file.  The sender
  102.          may not have write privileges to the directory, or the directory
  103.          may not have been created.]
  104.  
  105.     {file server} - {user} - Logged to {userfile.msg}
  106.         [The "message text" was saved to the user's file and can be retrieved
  107.          with NGET.]
  108.  
  109.     {file server} - {user} - Server not mapped {file server}
  110.         [The sender has attached or logged into the file server, but has not
  111.          mapped a drive to the server.]
  112.  
  113.  
  114. Here is a typical NetWare login, attach, map, and NSend procedure:
  115.  
  116. C:\>ipx                                     Load IPX driver
  117. C:\>netx                                    Load NETX driver
  118. F:\LOGIN>login fs1/matthart                 Login to FS1
  119.  
  120. Drive  Z: = FS1\SYS:   \PUBLIC              Default drive mappings shown
  121.  
  122. Z:\PUBLIC>attach fs2/matthart               Attach to FS2
  123. Z:\PUBLIC>map y: = fs2/sys:                 Map Y: to FS2
  124. Z:\PUBLIC>attach fs3/matthart               Attach to FS3
  125. Z:\PUBLIC>map x: = fs3/sys:                 Map X: to FS3
  126.  
  127. Z:\PUBLIC>nsend "hello" to everyone,fs2/everyone,fs3/everyone
  128.  
  129. Since I logged into FS1, FS1 becomes my "preferred" and "primary" server.
  130. Messages sent to users or groups without specifying a file server will default
  131. to the preferred or primary server.
  132. ------------------------------------------------------------------------------
  133.  
  134.  
  135. NGET
  136. ------------------------------------------------------------------------------
  137. NGet is used in conjunction with NSend.  NGet retrieves any saved messages or
  138. text files and displays them.  The messages are shown, along with the date
  139. and time they were sent, in a last sent first shown order.  The last message
  140. sent to you is shown at the top of the list, with the oldest message sent
  141. at the bottom.  The only NGet parameter is:
  142.  
  143. NGet {config file}
  144.  
  145. The {config file} is a color and print configuration file.  Also, you can
  146. use an environment command to set the config file.  Use the command:
  147.  
  148. SET NGET={config file}
  149.  
  150. so the NGet will always load the {config file}.  The config file format is:
  151.  
  152. [COLORS]
  153. Foreground Normal         Default is 7
  154. Background Normal         Default is 0
  155. Foreground Highlight      Default is 0
  156. Background Highlight      Default is 7
  157. [PRINTER]
  158. Printer Port (1 or 2)     Default is 1
  159.  
  160. For example, I use:
  161.  
  162. [COLORS]
  163. 7,0,14,4
  164. [PRINTER]
  165. 1
  166.  
  167. saved to NGET.CFG.  The command:
  168.  
  169. C:\>SET NGET=C:\UTIL\NGET.CFG
  170.  
  171. is in my AUTOEXEC.BAT.
  172.  
  173. NGet startup messages are:
  174.  
  175.     NGet Error - Configuration File
  176.         [There was an error loading the configuration file information]
  177.     
  178.     Loading Attached Server Information...
  179.     Found {message file} On {server name}
  180.     Found {message file} On {server name}
  181.     No Messages in {message file}
  182.         [NGet will retrieve the message file names from attached servers.
  183.          NGet assumes that the higher drive letters will be mapped to the
  184.          servers, while lower drive letters will most likely be temporary
  185.          drives assigned during login.  Regardless, all files with messages
  186.          for the attached user will be loaded.]
  187.  
  188.     NGet - No Messages Found
  189.         Attached to {servers}
  190.         Attached to {servers}
  191.             [NGet has found valid attachments, but no messages.  The user
  192.              simply has no messages.]
  193.  
  194.     Loading Message Files...
  195.         Server {servers}
  196.         Server {servers}
  197.             [NGet is loading the message files]
  198.  
  199. The NGet message viewer
  200. -----------------------
  201. Once the messages have been loaded, a screen similiar to this will appear:
  202. ╔════════════════════════════════════════════════════════════════════════════╗
  203. ║ 01-17-1994 10:30  SUPERVISOR[15]: Testing NSend                            ║
  204. ║ 01-17-1994 10:00  BOBBYJONES[20]: I need that report!                      ║
  205. ║ 01-17-1994 09:00  JENNIFERJN[10]: Why were you late?                       ║
  206. ║                                                                            ║
  207. ║                                                                            ║
  208. ║                                                                            ║
  209. ║                                                                            ║
  210. ║                                                                            ║
  211. ║                                                                            ║
  212. ║                                                                            ║
  213. ║                                                                            ║
  214. ║                                                                            ║
  215. ║ FS1 as MATTHART├────────────────────────────────────────────────────────── ║
  216. ║ F1:Help   Alt-C:Clear   Alt-D:Del Line   F9:Previous   F10:Next   Esc:Exit ║
  217. ╚════════════════════════════════════════════════════════════════════════════╝
  218.  
  219. The current file server and login/attachment name is at the lower left corner
  220. of the screen.  Press F10 or F9 to switch to another message file, if one
  221. exists.  NGet will load all messages for any attachments and mappings your
  222. system has loaded.  For example, I may be "MATTHART" on FS1, "MATTH" on FS2,
  223. and "SUPERVISOR" on FS3.  If I am attached to all three servers, and I have
  224. mapped all three servers to a drive letter, then NGet will retrieve all
  225. three message files, and I can switch between them with F9/F10.  Once a message
  226. line has been read, press Alt-D to delete it.  You can press Alt-C to erase the
  227. entire file.  Press F1 for key help.  If all messages have been deleted, you
  228. will receive the message "No more messages." at the top of the screen.  You
  229. will receive the same message if no more messages exist when you press F9/F10.
  230. If additional messages have been logged while you were viewing, you will
  231. receive the message "You have additional messages.  Do you want to view them
  232. now?"  Press "Y" to view the messages, or "N" or "Esc" to continue.  This
  233. option is given when you escape or go to the next message file and NGet detects
  234. new messages.
  235. ------------------------------------------------------------------------------
  236.  
  237. NSend and NGet are written in Microsoft Professional Basic v. 7.1 with the
  238. QuickNet library from EllTech.  Tony Elliot of EllTech can be reached on
  239. CompuServe at 76220,2575 for more information regarding QuickNet.  Tell him
  240. that Matt Hart sent you!
  241.  
  242. Special thanks (and some of your registration dollars) go to Mike Bohn for
  243. the algorithms needed for NSend.  Basically, he didn't have the time to finish
  244. it or write NGet, so he gave me the code and said, "Make it work, please."
  245.  
  246. If you are a Windows user, check out The RIGHT Button in the WINSHARE forum
  247. of CompuServe, also by Mike and I.
  248.  
  249. Watch for a Windows version of NSend and NGet in the near future.
  250.  
  251. ------------------------------------------------------------------------------
  252. ---------------------------------------------------------------------------
  253. NSend/NGet Registration Form
  254.  
  255.     Mail to:
  256.         Matt E. Hart
  257.     Postal:
  258.         2516 W. Kingsport
  259.         Broken Arrow, OK  74011
  260.     CompuServe:
  261.         75450,3705
  262.  
  263. Name _______________________________________________________________
  264.  
  265. Address ____________________________________________________________
  266.  
  267. City, State, Zip ___________________________________________________
  268.  
  269. Type of Computer ___________________________________________________
  270.  
  271. Software Used ______________________________________________________
  272.  
  273. Disk Preference [ ] 5.25"  [ ] 3.5"
  274.  
  275. Number of disks ________
  276.  
  277. Cost per disk      25.00
  278.  
  279. Source code [ ]   200.00
  280.  
  281. Amount Enclosed ________
  282.  
  283. Suggestions, Comments ______________________________________________
  284.  
  285. ____________________________________________________________________
  286.  
  287. ____________________________________________________________________
  288. ------------------------------------------------------------------------------
  289.